home *** CD-ROM | disk | FTP | other *** search
/ Aminet 38 / Aminet 38 (2000)(Schatztruhe)[!][Aug 2000].iso / Aminet / disk / misc / Park.readme < prev    next >
Encoding:
Text File  |  2000-07-01  |  9.9 KB  |  285 lines
  1. Short:    Parks devices and loads and ejects media
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  1.10.1
  5. Type:     disk/misc
  6. Requires: Os 2.04
  7.  
  8. This tool ejects, parks or restarts a HD unit, either given by its DOS 
  9. device name or the name and unit of the exec device driver. All partitions 
  10. on the parked unit will be unaccessible to the dos afterwards. To be able to
  11. restart the HD, "Park" can be made resident.
  12.  
  13. _____________________________________________________________________________
  14.  
  15. Version 1.10.1:
  16.  
  17. Ooops. Forgot to include the 1.10 correctly. The 1.10 contained actually the
  18. 1.09 release of Park. Thanks to Nils Goers for detecting this fault.
  19. _____________________________________________________________________________
  20.  
  21. Version 1.10:
  22.  
  23. Major cleanup release. Added checks for some AFAIK undocumented SCSI ASC/ASCQ
  24. values I receive from my CD/RW which broke some commands. Added the "LOAD"
  25. argument to load a device (mainly CD-ROMs and related). Changed the ejection/
  26. loading/parking sequence a bit to keep care of some strange Iomega mechanisms.
  27. _____________________________________________________________________________
  28.  
  29. Version 1.09:
  30.  
  31. Added more sanity checks to avoid Enforcer hits.
  32. _____________________________________________________________________________
  33.  
  34. Version 1.08:
  35.  
  36. If the NOCHECK option is present, Park no longer rejects to "eject"
  37. empty drives, i.e. to open an empty CD drive or similar. 
  38. Thanks to Nils Goers for testing.
  39.  
  40. _____________________________________________________________________________
  41.  
  42. Version 1.07:
  43.  
  44. Fixed a bug that caused an unnecessary "out of memory" failure in case no
  45. disk to be ejected is present.
  46.  
  47. Park uses now a smarter algorithm to decide whether the given argument is
  48. a dos device or an exec device name.
  49.  
  50. Better check for the SCSI result codes, the error code returned is now
  51. more "AmigaDos like".
  52. _____________________________________________________________________________
  53.  
  54. Version 1.06:
  55.  
  56. Added a workaround for a feature of the gvpscsi.device and the FFS.
  57. _____________________________________________________________________________
  58.  
  59. Version 1.05:
  60.  
  61. Added a workaround for a bug in the AmiCFDS, added the NOCHECK option.
  62. _____________________________________________________________________________
  63.  
  64. Version 1.04:
  65.  
  66. Internal release, unpublished.
  67. _____________________________________________________________________________
  68.  
  69. Version 1.03:
  70.  
  71. Added the EJECT argument - *should* be used with the SCSI argument, too.
  72. Added the EJECTDELAY, STARTDELAY and FLUSHDELAY arguments that define 
  73. command specific delays.
  74. _____________________________________________________________________________
  75.  
  76. Version 1.02:
  77.  
  78. Park checks now if a device is already parked (or, to be precise, if the
  79. filing system is shut down) and fails if the user tries to park it again.
  80. _____________________________________________________________________________
  81.  
  82. Version 1.01:
  83.  
  84. Added an explicit check whether the handler name supplied does really contain
  85. a colon.
  86. _____________________________________________________________________________
  87.  
  88. Synopsis:
  89.  
  90. Park     HANDLER=DEVICE/A,UNIT/N,FLAGS/N,SCSI/S,
  91.     ON=START/S,EJECT/S,LOAD/S,EJECTDELAY/K/N,STARTDELAY/K/N,
  92.     FLUSHDELAY/K/N,INHIBITDELAY/K/N,NOCHECK/S
  93.  
  94. HANDLER:    DOS Device name to be parked, or name of the volume. To 
  95.         restart a unit, this must be the device name.
  96.         This *must* be the name of the dos device driver, i.e.
  97.         a string like "DH0:" or "SYS:".        
  98.         Alternatively, this may be the name of the exec.device, i.e.
  99.         "oktagon.device" or "gvpscsi.device".
  100.  
  101. UNIT:        The unit number of the exec device. Makes only sense if
  102.         HANDLER is an exec style device name.
  103.  
  104. FLAGS:        The flags for opening the device. Defaults to zero and is
  105.         usually not required.
  106.  
  107. SCSI:        If given, try to park the unit with direct SCSI commands.
  108.         This should work with all scsi.device compatible device
  109.         drivers.
  110.         If not given, try to use the TD_EJECT, CMD_START 
  111.         and CMD_STOP.
  112.  
  113.         Unfortunately, most device drivers do not support 
  114.         TD_EJECT, CMD_START/STOP. The "SCSI" keyword is 
  115.         therefore almost always required.
  116.  
  117. ON=START:    Restart the device and the partitions in question.
  118.  
  119. EJECT:        Eject the given device, if possible. In almost all
  120.         cases the SCSI keyword IS required since there is almost
  121.         no device which implements the - documented though -
  122.         command TD_EJECT
  123.  
  124. LOAD:        Loads the given device, e.g. CD-ROMs. Since there is no
  125.         exec command that is supposed to support this, the SCSI
  126.         keyword is mandatory here.
  127.  
  128. EJECTDELAY:    The delay in 50th of seconds Park should wait after
  129.         ejecting and before re-running the filing system. Defaults
  130.         to 50, i.e. one second.
  131.  
  132. STARTDELAY:    The delay in 50th of seconds Park has to wait after
  133.         having started a device until the filing system is allowed
  134.         to touch the disk again. Thus, this should be the spin-up
  135.         delay of the device. Defaults to 50, i.e. one second.
  136.  
  137. FLUSHDELAY:    The delay in 50th of seconds Park waits for the filing 
  138.         system to execute ACTION_FLUSH, i.e. to flush its buffers
  139.         to the disk. Unfortunately, this packet is broken - which
  140.         requires this ugly, and unsafe(!) workaround.
  141.  
  142. INHIBITDELAY:    The delay in 50th of a second park waits after stopping
  143.         the filing system and before parking the device. This is
  144.         required by the gvpscsi.device since this device fiddles
  145.         on its own in the device list of the DOS (Bah!) and may
  146.         lead to enforcer hits of the FFS. Defaults to one second. 
  147.  
  148. NOCHECK:    Bypasses the test if the filing system of the drive(s) to
  149.         be parked is up and working. If you see a message like
  150.         "Drive xyz is already stopped", but the handler is just
  151.         disabled for whatever reason, insert this argument.
  152.  
  153. _____________________________________________________________________________
  154.  
  155. Examples:
  156.  
  157. Park all partitions on the oktagon.device, unit 2: 
  158. (The oktagon knowns CMD_STOP, SCSI is not required)
  159.  
  160.     Park oktagon.device unit 2
  161.  
  162.  
  163. Park all partitions on the gvpscsi.device, unit 6:
  164. (The gvpscsi.device does NOT know the CMD_STOP, SCSI is required)
  165.  
  166.     Park gvpscsi.device unit 6 scsi
  167.  
  168. The "device" keyword is very important in both cases.
  169.  
  170.  
  171. Park the partition DH0: and all other partitions on the same device:
  172.  
  173.     Park DH0: scsi
  174.  
  175.  
  176. Restart DH0: and all other partitions on that device:
  177.  
  178.     Park DH0: on scsi
  179.  
  180.  
  181. Eject a ZIP drive, named ZIP:
  182.  
  183.     Park ZIP: scsi eject
  184.  
  185.  
  186. Eject a SCSI CD, named CD0:
  187.  
  188.     Park CD0: scsi eject nocheck flushdelay=0 ejectdelay=0
  189.  
  190. A flush delay isn't needed here because a CD filing system can't write
  191. anything to a CD.
  192.  
  193. _____________________________________________________________________________
  194.  
  195.                          The THOR-Software Licence (v2, 24th June 1998)
  196.  
  197.  
  198. This License applies to the computer programs known as "Park".
  199. The "Program", below, refers to such program. The "Archive" refers to 
  200. the package of distribution, as prepared by the author of the Program, 
  201. Thomas Richter. Each licensee is addressed as "you".
  202.  
  203.  
  204. The Program and the data in the archive are freely distributable
  205. under the restrictions stated below, but are also Copyright (c)
  206. Thomas Richter.
  207.  
  208. Distribution of the Program, the Archive and the data in the Archive by a
  209. commercial organization without written permission from the author to any
  210. third party is prohibited if any payment is made in connection with such
  211. distribution, whether directly (as in payment for a copy of the Program) or
  212. indirectly (as in payment for some service related to the Program, or
  213. payment for some product or service that includes a copy of the Program
  214. "without charge"; these are only examples, and not an exhaustive enumeration
  215. of prohibited activities).
  216.  
  217.  
  218. However, the following methods of distribution
  219. involving payment shall not in and of themselves be a violation of this
  220. restriction:
  221.  
  222.  
  223. (i) Posting the Program on a public access information storage and
  224. retrieval service for which a fee is received for retrieving information
  225. (such as an on-line service), provided that the fee is not
  226. content-dependent (i.e., the fee would be the same for retrieving the same
  227. volume of information consisting of random data).
  228.  
  229.  
  230. (ii) Distributing the Program on a CD-ROM, provided that
  231.  
  232. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  233. especially this licence agreement;
  234.  
  235. b) the CD-ROM is made available to the public for a nominal fee only,
  236.  
  237. c) a copy of the CD is made available to the author for free except for
  238. shipment costs, and
  239.  
  240. d) provided further that all information on such CD-ROM is redistributable
  241. for non-commercial purposes without charge.
  242.  
  243.  
  244. Redistribution of a modified version of the Archive, the Program or the
  245. contents of the Archive is prohibited in any way, by any organization,
  246. regardless whether commercial or non-commercial. Everything must be kept
  247. together, in original and unmodified form.
  248.  
  249.  
  250.  
  251.  
  252. Limitations.
  253.  
  254.  
  255. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  256. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  257. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  258. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  259. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  260. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  261. SERVICING, REPAIR OR CORRECTION.
  262.  
  263.  
  264. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  265. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  266. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  267.  
  268.  
  269.                                                         Thomas Richter
  270. ____________________________________________________________________________
  271.  
  272. Thomas,        
  273.     June 2000
  274.  
  275.  
  276. ============================= Archive contents =============================
  277.  
  278. Original  Packed Ratio    Date     Time    Name
  279. -------- ------- ----- --------- --------  -------------
  280.     3904    2385 38.9% 03-Jun-00 12:00:48 +Park
  281.     9696    3793 60.8% 03-Jun-00 12:02:02 +Park.readme
  282.      856     379 55.7% 19-Apr-98 17:36:02 +Park.readme.info
  283. -------- ------- ----- --------- --------
  284.    14456    6557 54.6% 06-Jun-100 21:42:52   3 files
  285.